home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / gfx / conv / JpegTool.lha / JpegTool / JpegTool.doc < prev   
Text File  |  1999-02-25  |  4KB  |  120 lines
  1.                       JpegTool
  2.         © 1999 by Stephan Rupprecht
  3.             All rights reserved.
  4.  
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  JpegTool is copyrighted 1999 by Stephan Rupprecht. All rights
  8.  reserved. This program is freeware, so no financial donations
  9.  required. Redistribution allowed if the package is left unchanged.
  10.  The author is not responsible for any damage caused by the use
  11.  or misuse of this documentation and/or the program(s) it describes.
  12.  
  13.  
  14. REQUIREMENTS
  15.  Any Amiga® (compatible) computer with at least OS3 and '020+ cpu.
  16.  jpeg.library v2+ by Paul Huxham (util/libs/jpeglibrary*.lha or
  17.   http://mafeking.scouts.org.au/~paulh).
  18.  picture.datatype v43 and datatypes.library v45 (optional, see later).
  19.  
  20.  
  21. DESCRIPTION
  22.  JpegTool allows you to convert any image that is recognized by 
  23.  datatypes into a jpeg image and vice versa.
  24.  
  25.  Features (mainly provided by jpeg.library)
  26.   · can create thumbnails from jpegs.
  27.   · allows to create progressive images (jpeglib v5).
  28.   · provides block smoothing for decompression (jpeglib v5).
  29.   · dct method (jpeglib v4) as well as quality and smoothing
  30.     factor can be changed.
  31.   · optionally creates grayscale images.
  32.  
  33.  
  34. INSTALLATION
  35.  Simply copy JpegTool to where-ever-you-want :)
  36.  
  37.  
  38. USAGE
  39.  You can start JpegTool only from shell, since it's a DOS command
  40.  (except for the possibility to start it from Workbench through
  41.  the menu item 'Execute Command...'). The following options are
  42.  provided:
  43.  
  44.     FROM/A,TO/A,DESTDATATYPE=DATATYPE=DTN,Q=QUALITY/N/K,
  45.     S=SMOOTHING/N/K,DCT=DCTMETHOD/K,BS=BLOCKSMOOTHING/S,
  46.     P=PROGRESSIVE/S,SN=SCALENUM/N/K,SD=SCALEDENOM/N/K,
  47.     GS=GRAYSCALE/S,QUIET/S
  48.  
  49.  FROM/A specifies the image to convert and TO/A the destination
  50.  file. Once de-/encoding an jpeg stream has been started, it can be
  51.  aborted by pressing ctrl-c.
  52.  
  53.  DESTDATATYPE=DATATYPE=DTN: Tells the program to create a datatypes
  54.   object from a jpeg stream. To create an ilbm picture specify
  55.   DTN=picture (no .datatype ending!). This option requires picture
  56.   datatype v43 and datatypes.library v45! And, of course, the
  57.   specified subclass of picture    dt must be v43 compatible and provide
  58.   an encoder.
  59.  
  60.  Q=QUALITY/N/K: quality of the jpeg stream to create (1%..100%).
  61.   default: 75
  62.  
  63.  S=SMOOTHING/N/K: smoothing factor of the jpeg stream to create
  64.   (0%..100%). default: 0 (= no smoothing)
  65.  
  66.  DCT=DCTMETHOD/K: allows to specify the dct method used for
  67.   de-/encoding. The following keywords are recognized:
  68.     ISLOW: integer, slow, more accurate (default).
  69.     IFAST: integer, fast, less accurate.
  70.     FLOAT: float, fast on fast machines, most accurate.
  71.  
  72.  BS=BLOCKSMOOTHING/S: do block smoothing when decompressing.
  73.   default: off
  74.  
  75.  P=PROGRESSIVE/S: create progressive jpeg.
  76.   default: off
  77.  
  78.  SN=SCALENUM/N/K: scaling numerator when decompressing a jpeg image.
  79.   The jpeg code only supports a value of 1 (default) currently.
  80.  
  81.  SD=SCALEDENOM/N/K: scaling denominator when decompressing a jpeg
  82.   image. Denominators supported are 1 (default), 2, 4 and 8. Eg. if
  83.   you want to have an image that is halve of the size of the original 
  84.   one specify SD=2.
  85.  
  86.  GS=GRAYSCALE/S: create grayscale image. default: off.  
  87.  
  88.  QUIET/S: suppresses any message except error messages.
  89.   default: off
  90.  
  91.  
  92. HISTORY
  93.  1.0  first public release
  94.  1.1  fixed a few non-serious bugs. added grayscale option. creates
  95.       an 8bit image from a grayscale jpeg, now (before truecolor).
  96.       fixed p96 picturedt problems.
  97.  
  98. FUTURE
  99.  a gui ?
  100.  bugfixes ;)
  101.  your suggestions
  102.  
  103.  
  104. SPECIAL THANKS GO TO
  105.  Paul Huxham for his jpeg.library.
  106.  Olaf Barthel for his help.
  107.  
  108.  
  109. AUTHOR
  110.  Please send bug reports and ideas to
  111.  
  112.      Stephan Rupprecht
  113.      Apfeldweg 1
  114.      D44359 Dortmund
  115.      Germany
  116.  
  117.  Send emails to
  118.  
  119.      stephan.rupprecht@gmx.de
  120.